扩展知识

下面来增强 HOMESTEAD 系统的使用，尤其是 WINDOWS 用户可能主要登录 HOMESTEAD 系统开发，所以更有必要学习本章。

常用命令

#启动 如果加上 --provision 选项那么添加的新站点会发布到虚拟机上。
cd ~/homestead && vagrant up

#关闭
vagrant halt

#通过 SSH 登录 vagrant（需要先启动 vagrant）
vagrant ssh

#查看目前安装的box列表
vagrant box list

#删除box镜像
vagrant box remove laravel/homestead

#删除指定版本
vagrant box remove laravel/homestead --box-version 9.5.0

#查看当前 homestead 虚拟机的状态。
vagrant status

#升级盒子
vagrant box update

离线安装

由于网络问题可能会造成下载 box 失败，此时可以尝试使用以下方式离线安装。

首先下载管理脚本

#clone管理脚本
git clone https://github.com/laravel/homestead.git ~/homestead
cd ~/homestead

#创建 Homestead.yaml 配置文件
./init.bat

打开配置文件 homestead/scripts/homestead.rb 修改版本号为 0

config.vm.box_version = settings["version"] ||= ">= 0"

复制下面的链接到迅雷下载镜像，下面的版本号 9.5.1 可以根据需要修改

https://vagrantcloud.com/laravel/boxes/homestead/versions/10.1.1/providers/virtualbox.box

将下载的镜像放在 ~/homestead 目录中，然后进入 ~/homestead 目录执行以下命令

vagrant box add laravel/homestead ./virtualbox.box

现在已经安装好了，可以正常使用了

ZSH

安装 ZSH 可以增强命令行操作体验，比如历史命令的提示，下面来介绍安装方式。

系统已经安装了 ZSH 所以我们只需要装些插件和做些配置就可以使用了

修改 Homestead.yaml 配置文件并开启 ohmyzsh

features:
  ...
  - ohmyzsh: true
  ...

重新使用新配置项启动 HOMESTEAD

homestead reload --provision

homestead ssh

安装命令提示插件

git clone https://github.com/zsh-users/zsh-autosuggestions ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-autosuggestions

修改~/.zshrc 配置文件

plugins=(git history history-substring-search node npm wd web-search last-working-dir zsh-autosuggestions vi-mode)

更新配置也可以选择重起终端

source ~/.zshrc

常见问题

vagrant 密码

homestead 里执行 npm 报错

这个问题经常发生在 windows 系统中，主要是 windows 权限的问题。请使用以下任意方法解决

在执行 git bash 时，右键使用管理员执行
在 windows 系统执行 npm 命令

413 Request Entity Too Large

这是 nginx 配置可上传文件文件尺寸过小

修改sudo vim /etc/nginx/nginx.conf配置文件中的 http 配置段，添加以下配置项

http {
	...
	client_max_body_size 100m;
	...
}

扩展知识 ​

常用命令 ​

离线安装 ​

ZSH ​

常见问题 ​

vagrant 密码 ​

homestead 里执行 npm 报错 ​

413 Request Entity Too Large ​